home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d10 / calsk102.arc / CALSK2.DOC < prev    next >
Text File  |  1991-05-12  |  45KB  |  1,096 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                        CALSK2
  9.  
  10.  
  11.                               Version 1.0 -- April 1991
  12.  
  13.  
  14.                        CALendar preview report for SideKick 2
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                        Copyright (c) 1991 WetZoft Applications
  25.  
  26.  
  27.  
  28.                                  All Rights Reserved
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.                         _______
  49.                    ____|__     |               (tm)
  50.                 --|       |    |-------------------
  51.                   |   ____|__  |  Association of
  52.                   |  |       |_|  Shareware
  53.                   |__|   o   |    Professionals
  54.                 -----|   |   |---------------------
  55.                      |___|___|    MEMBER
  56.  
  57.  
  58.  
  59.  
  60.                                   Table of Contents
  61.  
  62.  
  63.           I. Introduction............................................1
  64.             A. What Is CALSK2 ?......................................1
  65.             B. CALSK2's Current Limitations & Restrictions...........1
  66.             C. Files Included on Distribution Disk...................1
  67.             D. Shareware.............................................2
  68.  
  69.           II. Legal Stuff............................................2
  70.             A. Trademarks Mentioned..................................2
  71.             B. Copyright Notice And License..........................2
  72.             C. Warranty..............................................3
  73.             D. Registration..........................................3
  74.             E. Support...............................................3
  75.             F. Bulletin Boards, Users Groups And Disk Vendors........4
  76.  
  77.           III. Command Line Options:.................................5
  78.             A. /B {Begin Date}.......................................5
  79.             B. /C {Calendar} ........................................5
  80.             C. /D {Days}.............................................5
  81.             D. /E {End Date}.........................................6
  82.             E. /F {File Out}.........................................6
  83.             F. /H {Help} ............................................6
  84.             G. /L {Look Ahead} ......................................6
  85.             H. /N {Print Notes}......................................6
  86.             I. /P {Print Output}.....................................7
  87.             J. /R {Print Reminders Only}.............................7
  88.             K. /S {Search}...........................................7
  89.             L. /T {Task File}........................................8
  90.             M. /V {Max Video}........................................8
  91.             N. /W {Weekly Separators}................................8
  92.             O. /? {Help}.............................................8
  93.             P. Sample Command Lines..................................8
  94.  
  95.           IV. Error Messages.........................................9
  96.  
  97.           V. Sample Report Format:..................................10
  98.  
  99.           VI. Installation Program..................................10
  100.             A. Default Datafile Path & Filename.....................11
  101.             B. Default Days for Report..............................11
  102.             C. Default Output Disk File Name Help...................12
  103.             D. Default Screen Colors................................12
  104.             E. Print Initialization / Termination Strings...........12
  105.             F. Default Print Page Length............................12
  106.             G. Default Video Mode...................................12
  107.             H. Weekly Separators Option.............................12
  108.             I. Print Note Option....................................12
  109.             J. Default Time Format..................................13
  110.             K. Default ToDo/RTM Task File Location..................13
  111.             L. Task Print Before/After Appointments.................13
  112.  
  113.           CALendar preview report for SideKick 2 Documentation         Page: i
  114.  
  115.  
  116.             M. Reminder / Look Ahead Characters.....................13
  117.             N. Look Ahead Days......................................14
  118.             O. Print End Times......................................14
  119.             P. Always Include Task File.............................14
  120.             Q. Task Due Messages....................................14
  121.  
  122.           VII. ASSOCIATION OF SHAREWARE PROFESSIONALS...............14
  123.             A. The primary goals of the ASP:........................15
  124.  
  125.           VIII. OTHER PROGRAMS BY WETZOFT APPLICATIONS..............15
  126.             A. Resident-TaskManager - RTM...........................15
  127.             B. CALRPT...............................................15
  128.             C. CALTRV...............................................16
  129.  
  130.           IX. Version History.......................................16
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.           CALendar preview report for SideKick 2 Documentation         Page: ii
  171.  
  172.  
  173.           I. Introduction
  174.  
  175.              A. What Is CALSK2 ?
  176.  
  177.                CALSK2 is a program that produces a formatted preview of
  178.           your appointment and tasks (Screen, Printer, or File) from
  179.           Sidekick 2's Calendar file without invoking Sidekick 2. This is
  180.           especially helpful in your AUTOEXEC file to show you what is on
  181.           your Calendar for the next few days. To invoke CALSK2 just type
  182.           CALSK2 from the DOS command line or place the command CALSK2
  183.           somewhere in your AUTOEXEC.BAT file.
  184.  
  185.           For Help on Parameters and to find out the defaults - type:
  186.  
  187.           C:\>CALSK2 /?
  188.  
  189.                Also available to CALSK2 users is Resident-TaskManager (See
  190.           - Other Programs by WetZoft Applications later in this document).
  191.           Resident-TaskManager is a full function Task/ToDo list manager.
  192.           Together with CALSK2 you can integrate your task list with your
  193.           calendar to get a comprehensive list of your daily activities.
  194.           See the /T option described later in this document.
  195.  
  196.              B. CALSK2's Current Limitations & Restrictions
  197.  
  198.           845 Appointments within selected time span
  199.           50  Notes per day
  200.  
  201.              C. Files Included on Distribution Disk
  202.  
  203.           The CALSK2 Distribution Disk contains the following files:
  204.  
  205.           CALSK2.EXE     - The CALSK2 program
  206.           CALSK2.DOC     - This file
  207.           CALSINST.EXE   - An installation program
  208.           README         - Changes or important information not included in
  209.                            the printed documentation (CALSK2.DOC).
  210.           REGISTER.BAT   - A BATch file to print out the registration form
  211.                            to your printer (LPT1)
  212.           REGFORM.DOC    - The actual Registration Form
  213.           PRINTDOC.BAT   - A BATch file to print out this documentation
  214.                            file to your printer (LPT1)
  215.           VENDOR.DOC     - Instructions to Disk Vendors who wish to
  216.                            distribute CALSK2.
  217.  
  218.                Copy these files onto your disk into your Sidekick 2
  219.           directory. Then, consider how you want to run CALSK2 and set your
  220.           options (See: Installation Program later in this file). Once
  221.           installed, the only file you need to keep on your disk is
  222.           CALSK2.EXE. We recommend you keep the install program close by in
  223.           case you want to change any of your defaults.
  224.  
  225.  
  226.  
  227.  
  228.           CALendar preview report for SideKick 2                       Page: 1
  229.  
  230.  
  231.           ***Note - You can place CALSK2 in another directory as long as a
  232.           copy of the file PXENGINE.OVL (that came with SideKick 2) is in
  233.           the same directory or DOS Path.
  234.  
  235.              D. Shareware
  236.  
  237.                Shareware is a distribution method, not a type of software.
  238.           You should find software that suits your needs and pocketbook,
  239.           whether it's commercial or Shareware. The Shareware system makes
  240.           fitting your needs easier, because you can try before you buy.
  241.           And because the overhead is low, prices are low also. Shareware
  242.           has the ultimate money-back guarantee -- if you don't use the
  243.           product, you don't pay for it.
  244.  
  245.                CALSK2 is distributed as Shareware -- this means WetZoft
  246.           Applications encourages users, subject to restrictions described
  247.           below, to share copies of this program with friends, associates
  248.           and bulletin boards. You may not share the registered version of
  249.           Resident Task Manager.
  250.  
  251.                If you make copies of CALSK2, you must include all files in
  252.           the original distribution file.  You are not permitted to
  253.           distribute CALSK2 without this documentation.
  254.  
  255.           II. Legal Stuff
  256.  
  257.              A. Trademarks Mentioned
  258.  
  259.           Sidekick 2 is a trademark of Borland International.
  260.  
  261.              B. Copyright Notice And License
  262.  
  263.                This document; other accompanying written and disk-based
  264.           notes and specifications; and all referenced and related program
  265.           files, demonstration code and object modules accompanying this
  266.           document are copyrighted by WetZoft Applications.  The copyright
  267.           owner hereby licenses you to: initial use of the software; make
  268.           as many copies of the software and documentation as you wish;
  269.           give exact copies of the original to anyone; and distribute the
  270.           software and documentation in its unmodified form via electronic
  271.           means.  There is no charge for any of the above.
  272.  
  273.                This is not free software.  This license allows you to use
  274.           this software without charge for a period of 30 days. In order to
  275.           continue using this software, include this software as part of
  276.           any product, either commercial, shareware, freeware, or public
  277.           domain, REGISTRATION IS REQUIRED.  Any other use of CALSK2 is in
  278.           violation of federal copyright laws.
  279.  
  280.                No copy of the software may be distributed or given away
  281.           without this accompanying documentation; this notice must not be
  282.           removed.  ONLY COPIES OF THE SHAREWARE VERSION MAY BE DISTRIBUTED
  283.           IN ANY FORM.  Contact WetZoft Applications if you receive a copy
  284.           that does not comply with these requirements.
  285.  
  286.           CALendar preview report for SideKick 2                       Page: 2
  287.  
  288.  
  289.              C. Warranty
  290.  
  291.                There is no warranty of any kind associated with this
  292.           software, and the copyright owner is not liable for damages of
  293.           any kind.  By using this software, you agree to this. Every
  294.           effort has been made by WetZoft Applications to make this product
  295.           bug-free.  However, the nature of software development is that it
  296.           is impossible to guarantee bug-free software. Every attempt will
  297.           be made to correct any verifiable bug reported. Upgrades will be
  298.           made available to all registered users.
  299.  
  300.              D. Registration
  301.  
  302.                To register CALSK2 fill out the registration form included
  303.           on the distribution disk, and send a check or money order (in US
  304.           funds only) for the appropriate amount to:
  305.  
  306.                     WetZoft Applications
  307.                     788 Martin Ct West
  308.                     Severn MD 21144-2213
  309.  
  310.                Upon receipt of the appropriate registration fee, WetZoft
  311.           Applications will acknowledge the registration and
  312.  
  313.           .    Provide the user with the codes necessary to remove the
  314.                shareware registration screen.
  315.  
  316.           .    Provide the user with a registration number entitling the
  317.                user to upgrades and telephone support.
  318.  
  319.           .    Provide the user with a printed copy of the documentation
  320.                and the latest copy of the software. Please specify disk
  321.                size on the registration form. If no disk size is specified
  322.                5 1/4 inch disks will be sent.
  323.  
  324.                The registration fee is for the use of a single copy of
  325.           CALSK2 by ONE individual. CALSK2 may be used on any computer
  326.           owned by the registered user so long as there is NO possibility
  327.           of CALSK2 being used at more than one location at the same time.
  328.           Please contact WetZoft Applications for information on multiple
  329.           copy registration and site licenses.
  330.  
  331.                Telephone support will only be provided to registered users.
  332.           If you need technical assistance and you are NOT registered, you
  333.           may either write to WetZoft Applications the address above, or
  334.           contact the author on Compuserve:
  335.  
  336.                     Jim Wetzel [75166,3200]
  337.                     E-Mail, BORAPP
  338.  
  339.              E. Support
  340.  
  341.                Registered Users of CALSK2 are entitled to the following
  342.           support:
  343.  
  344.           CALendar preview report for SideKick 2                       Page: 3
  345.  
  346.  
  347.                .    CompuServe - The preferred method of support is via
  348.                     CompuServe. Technical questions and inquires can be E-
  349.                     Mailed to: Jim Wetzel [75166,3200].
  350.  
  351.                .    Mail Support - You can send all questions and inquires
  352.                     to the address listed above. WetZoft Applications will
  353.                     respond as promptly as possible to your inquiry.
  354.  
  355.                .    Telephone Support - Registered users may call WetZoft
  356.                     Applications at (301)-969-9385 for technical support.
  357.                     Voice response is generally available weekday evenings.
  358.                     Messages are checked periodically throughout the day.
  359.  
  360.                For Non-Registered users of CALSK2, we will provide you with
  361.           assistance to install a shareware copy of CALSK2 and evaluate it
  362.           during the 30 day evaluation period. WetZoft Applications cannot
  363.           guarantee continued support to Non-Registered Users beyond the 30
  364.           day evaluation period.
  365.  
  366.              F. Bulletin Boards, Users Groups And Disk Vendors
  367.  
  368.                UNDER NO CIRCUMSTANCES MAY CALSK2 BE DISTRIBUTED WITHOUT ALL
  369.           ACCOMPANYING DOCUMENTATION FILES (INCLUDING THIS COMPLETE FILE),
  370.           ALL PROGRAMS, AND OTHER MATERIALS PROVIDED WITH THE OFFICIAL
  371.           COPIES FROM WETZOFT APPLICATIONS.  ANY OTHER SUCH DISTRIBUTION OF
  372.           CALSK2 OR ITS RELATED FILES, EXCEPT AS PROVIDED FOR IN THIS
  373.           LICENSE, SHALL BE DETERMINED TO BE IN VIOLATION OF FEDERAL
  374.           COPYRIGHT LAWS.
  375.  
  376.                SEE VENDOR.DOC FILE FOR OTHER INFORMATION.
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.           CALendar preview report for SideKick 2                       Page: 4
  403.  
  404.  
  405.           III. Command Line Options:
  406.  
  407.           Usage: CALSK2 [Options]
  408.           Options: Space is required between /Option & Parameter
  409.              /B MM/DD/YY    {Begin Date}           Default=Todays Date
  410.              /C filename    {Calendar}             Default=APP.DB
  411.              /D 1-365/999   {Days Normal/Search}   Default=7
  412.              /E MM/DD/YY    {End Date}             Default=Begin Date+Days
  413.              /F [filename]  {File Out}             Default=Screen Output
  414.              /H             {Help}                 This Help Screen
  415.              /L [nnn]       {Look Ahead Feature}   Default=No Look Ahead
  416.              /N [nn]        {Note Limit}           Default=No Notes
  417.              /P             {Print Output}         Default=Screen Output
  418.              /R             {Print Reminders Only} Default=Full Report
  419.              /S string      {Search Only}          Default=Std Processing
  420.              /T [filename]  {Task File}            Default=SK2
  421.              /V             {Max Video}            Default=25 Lines
  422.              /W             {Weekly Separators}    Default=None
  423.              /?             {Help}                 This Help Screen
  424.  
  425.           Please note that a space IS REQUIRED between the option switch
  426.           '/o' and it's parameter. Dates MUST be in the form MM/DD/YY (all
  427.           2-Digit Numbers). Under DOS 3.x and above CALSK2 will search for
  428.           the Time Planner file "/C" in the following places:
  429.  
  430.              Current Directory
  431.              Directory where CALSK2 resides (It's a good idea to put CALSK2
  432.              in the same directory as SideKick 2
  433.              DOS Path
  434.  
  435.              A. /B {Begin Date}
  436.  
  437.           /B {Begin Date} - CALSK2 will start its report with the date
  438.                specified by the user. The Date format is: MM/DD/YY.  Month
  439.                and Day must be valid 2 digit date numbers: Month (01-12),
  440.                Day (01->Days in Month). The default is today's (system)
  441.                date.
  442.  
  443.              B. /C {Calendar}
  444.  
  445.           /C {Calendar} - This parameter is used to tell CALSK2 what
  446.                Sidekick 2 Time Planner file to use. The default is APP.DB.
  447.                If the specified file cannot be found in the Current
  448.                Directory CALSK2 will search for the file (DOS 3.x and
  449.                higher) in the directory where CALSK2 resides and the DOS
  450.                Path. Full Drive and Path information is accepted.  ** This
  451.                is an installable option.
  452.  
  453.              C. /D {Days}
  454.  
  455.           /D {Days} - This parameter is used to tell CALSK2 how many days
  456.                of calendar data you want to appear on the report. The valid
  457.                range is 1 to 365. The default is 7. ** This is an
  458.                installable option.
  459.  
  460.           CALendar preview report for SideKick 2                       Page: 5
  461.  
  462.  
  463.              D. /E {End Date}
  464.  
  465.           /E {End Date} - CALSK2 will end its report with the date
  466.                specified by the user. The Date format is: MM/DD/YY.  Month
  467.                and Day must be valid 2 digit date numbers: Month (01-12),
  468.                Day (01-Day in Month). The default is todays (system) date.
  469.                /E overrides the /D option. The default is the Begin
  470.                Date(/B) + Days(/D)
  471.  
  472.              E. /F {File Out}
  473.  
  474.           /F {File Out} - Optionally CALSK2 can write its report out to a
  475.                disk file. The default filename used is APP.RPT and will be
  476.                written in the current directory. No checking is done to see
  477.                if the file already exists so BE CAREFUL! If /F is specified
  478.                with no other parameters the default Report File name is
  479.                used. You can also specify the name of the file you want to
  480.                use after the /F.
  481.  
  482.                Examples:
  483.  
  484.                CALSK2 /F /D 20     Writes a 20 day report to APP.RPT
  485.                CALSK2 /F MYFILE.CAL /D 20    Writes a 20 day report to
  486.                MYFILE.CAL
  487.  
  488.                ** This is an installable option.
  489.  
  490.              F. /H {Help}
  491.  
  492.           /H {Help} - Tells CALSK2 to list a short help screen for the
  493.                user.
  494.  
  495.              G. /L {Look Ahead}
  496.  
  497.           /L [nnn]  - Tells CALSK2 to "Look Ahead" for future "designated"
  498.                appointments by specifying /L [nnn] on the command line. The
  499.                [nnn] is an optional number of days to Look Ahead. The
  500.                default is 45 and can be changed in the install program.
  501.                Appointments are "designated" by adding a "@" character
  502.                (installable) somewhere in the appointment. Look Ahead does
  503.                NOT search repeating appointments. The Look Ahead search
  504.                begins with the Begin Date Specified/Default in CALSK2.
  505.  
  506.              H. /N {Print Notes}
  507.  
  508.           /N {Print Notes} - CALSK2 will optionally display a limited
  509.                amount (4096 bytes) of note information that is attached to
  510.                an Appointment or ToDo item. There are a few restrictions:
  511.                1) Note lines are limited to 65 characters (you can have
  512.                longer lines in SK 2 but the printed report will be
  513.                truncated) 2) The screen display will only show 15 (more if
  514.                Max Video /V specified) note lines. 3) the printed report
  515.                will show up to 50 note lines. If /N is specified by itself
  516.                CALSK2 will print out as much of the note as possible. If an
  517.  
  518.           CALendar preview report for SideKick 2                       Page: 6
  519.  
  520.  
  521.                optional number is provided CALSK2 will limit the number of
  522.                note lines printed to the number specified (within the
  523.                limits described above).
  524.  
  525.                Examples:
  526.  
  527.                CALSK2 /N Writes a 7 day report with attached notes.
  528.                CALSK2 /N 4    Writes a 7 day report with attached notes but
  529.                only printing a maximum of 4 lines per note.
  530.  
  531.              I. /P {Print Output}
  532.  
  533.           /P {Print Output} - Tells CALSK2 to route its report to the
  534.                printer. CALSK2 will issue user defined Printer
  535.                Setup/Termination Strings and will accept a User Defined
  536.                Page Size. ** This is an installable option.
  537.  
  538.              J. /R {Print Reminders Only}
  539.  
  540.           /R {Print Reminders Only} - This option instructs CALSK2 to print
  541.                only the reminder report. CALSK2 has a feature that will
  542.                allow you to keep track of certain tasks or other items
  543.                using your SK 2 calendar. This feature is called REMINDERS.
  544.                Just enter a "!" in any (non-repeating) Appointment or Title
  545.                record and the Description will appear (if prior to the
  546.                report end date) on a report after the end of the normal
  547.                CALendar RePorT. The default is to print the full report.
  548.                This option suppresses the standard CALendar RePorT
  549.  
  550.                *** Note: When using the reminder feature, CALSK2 will
  551.                read the entire Time Planner file from the beginning
  552.                instead of skipping right to the start date. Since this
  553.                slows processing on large Time Planner files this feature
  554.                is turned off by default. To activate it enter the
  555.                character you want to use as the "Reminder" character
  556.                through the install program.
  557.  
  558.                
  559.              K. /S {Search}
  560.  
  561.           /S {Search} - CALSK2 has the ability to search your Calendar for
  562.                a user specified string over a 999 day time span. Search is
  563.                case INsensitive and the search string should be enclosed in
  564.                quotes if the it contains blanks or special characters. When
  565.                Search is active Weekly Separators are turned off.
  566.  
  567.                Examples:
  568.  
  569.                CALSK2 /S Birthday /D 20    Searches your calendar for any
  570.                birthdays over the next 20 days.
  571.  
  572.                CALSK2 /S "Visit Mom" /D 365 Searches your calendar for any
  573.                time you were supposed to visit your mother!
  574.  
  575.  
  576.           CALendar preview report for SideKick 2                       Page: 7
  577.  
  578.  
  579.              L. /T {Task File}
  580.  
  581.           /T {Task File} - CALSK2 will integrate the Sidekick's ToDo list
  582.                with the CALendar reports if you specify "SK2" in the
  583.                installation program and /T on the command line. Or you can
  584.                specify /T SK2 on the command line. Optionally, CALSK2 will
  585.                read Task files from Resident TaskManager(RTM) when you
  586.                specify the /T option on the command line.  If you wish to
  587.                use the Resident TaskManager file enter the name here.
  588.                Format is: d:\PATH\FILENAME.EXT. Please make sure the Task
  589.                File EXISTS!  You can always specify a different file on the
  590.                command line with /T [Filename]. Resident TaskManager is
  591.                available separately from WetZoft Applications.
  592.  
  593.                Examples:
  594.  
  595.                CALSK2 /T /D 20     Produces a 20 day report with Sidekick's
  596.                ToDo List
  597.                CALSK2 /T MYTASKS.DAT /D 20   Produces the same report with
  598.                MYTASKS.DATA from RTM
  599.  
  600.                Please note that if you have a Task Due 21 Days or more from
  601.                the starting date of the report CALSK2 will not include it
  602.                into the report. CALSK2 looks for PAST DUE Tasks and all
  603.                TASKS up to and including the Report End Date.
  604.  
  605.                ** This is an installable option.
  606.  
  607.              M. /V {Max Video}
  608.  
  609.           /V {Max Video} - This option instructs CALSK2 to use the maximum
  610.                video mode available for the monitor type being used (44
  611.                Lines EGA/50 Lines VGA). ** This is an installable option.
  612.  
  613.              N. /W {Weekly Separators}
  614.  
  615.           /W {Weekly Separators} - This option instructs CALSK2 to print
  616.                out a separator line at the end of each week. ** This is an
  617.                installable option.
  618.  
  619.              O. /? {Help}
  620.  
  621.           /? {Help} - Tells CALSK2 to list a short help screen for the
  622.                user.
  623.  
  624.              P. Sample Command Lines
  625.  
  626.  
  627.            List (Screen) all appointments for the next 10 days
  628.  
  629.  
  630.              C:\>CALSK2 /d 10
  631.  
  632.  
  633.  
  634.           CALendar preview report for SideKick 2                       Page: 8
  635.  
  636.  
  637.  
  638.            List (Printer) all appointments for the next 10 days
  639.  
  640.  
  641.              C:\>CALSK2 /d 10 /p
  642.  
  643.  
  644.            List (Printer) all appointments for June 1989
  645.  
  646.  
  647.              C:\>CALSK2 /b 06/01/89 /d 30 /p
  648.  
  649.              *** Note the two digit month & day
  650.  
  651.  
  652.            List (Screen) appointments for the next 7 days in your Common
  653.            App File
  654.  
  655.  
  656.              C:\>CALSK2 /c C:\SK2\TIMEPLAN\COMMON.DB
  657.  
  658.              *** Note: 7 Days is default so does not need to be specified
  659.  
  660.           IV. Error Messages
  661.  
  662.           Listed below are error messages generated by CALSK2 and possible
  663.           explanations:
  664.  
  665.           *** ERROR! mm/dd/yy Invalid Begin Date Specified
  666.  
  667.              This message is generated when an invalid Begin Date /B is
  668.              specified. This could be the result of invalid month or day
  669.              values or the month or day value was specified with a single
  670.              digit.
  671.  
  672.           *** ERROR! mm/dd/yy Invalid End Date Specified
  673.  
  674.              This message is generated when an invalid End Date /E is
  675.              specified. This could be the result of invalid month or day
  676.              values or the month or day value was specified with a single
  677.              digit.
  678.  
  679.           *** Warning: End Date < Begin Date --- Begin/End Date Forced
  680.           Equal
  681.  
  682.              This message is generate when the End Date is chronologically
  683.              prior to the Begin Date.
  684.  
  685.           *** Warning: Appointment Limit Exceeded. nnn  Appointment Records
  686.           Skipped!
  687.  
  688.              CALSK2 has a limit (specified earlier) on the number of
  689.              Appointments it can store. If this limit is exceeded all
  690.              remaining appointment records are skipped. This usually
  691.  
  692.           CALendar preview report for SideKick 2                       Page: 9
  693.  
  694.  
  695.              results in a loss of repeating appointment records. Due to the
  696.              nature of the SK 2 calendar early repeating appointments may
  697.              be lost while later "standard" appointments will be shown.
  698.  
  699.           *** Warning: Insufficient Memory to Process Notes
  700.  
  701.              CALSK2 will store up to 4K bytes of note data per appointment.
  702.              Obviously every computer system has its memory limits. If you
  703.              use a lot of big notes you may run out of available memory.
  704.              You may also see this message if you run CALSK2 while shelled
  705.              out of another program.
  706.  
  707.           *** Warning: Note File(s) Missing! Note Processing Discontinued
  708.  
  709.              One or more of SideKick's Note files TP-nnnnn.TPN cannot be
  710.              found.
  711.  
  712.           *** ERROR! Filename Not Found or Invalid Calendar File Specified.
  713.  
  714.              This message is a result of CALSK2 not finding the filename
  715.              specified in the installation program or on the command line
  716.              with the /C option. Check the spelling and Drive and Path
  717.              information supplied.
  718.  
  719.      V. Sample Report Format:
  720.  
  721.      CALSK2 1.00: CALendar preview report for SK2     (c) WetZoft Applications
  722.      Calendar: C:\SK\TIMEPLAN\APP.DB    AS of: 04/18/91 10:00am         Page 1
  723.      =========================================================================
  724.        Date/Time      Description                                        Flags
  725.      =========================================================================
  726.      18-Apr-91 Tue
  727.           09:00a - 11:00a Supervisor's/Planning Meeting Rm 420             R N
  728.           01:00p - 02:00p Voice Mail Survey - Pick Up                       A
  729.           02:00p - 03:00p Problem Management Meeting Rm 1300               R
  730.  
  731.      19-Apr-91 Wed                                                         
  732.           09:00a - 10:00a Unit Supervisor's Meeting                        R
  733.  
  734.      -------------------------------------------------------------------------
  735.  
  736.           The Report is fairly self explanatory with the exception of the
  737.           Flags field. The flags indicate:
  738.  
  739.              R      - Repeating Appointment
  740.              N      - Attached Note
  741.              A      - Attached Alarm
  742.              H      - Hidden Appointment
  743.              ?      - UnConfirmed Appointment
  744.  
  745.           VI. Installation Program
  746.  
  747.                CALSK2 comes with a simple installation program. This
  748.           program allows you to set some of the DEFAULTS that CALSK2 uses.
  749.  
  750.           CALendar preview report for SideKick 2                       Page: 10
  751.  
  752.  
  753.           Most of these are pretty straight forward but a small explanation
  754.           is appropriate at this point.
  755.  
  756.                To use the installation program all you need to do is type
  757.           in CALSINST. CALSINST MUST be in the same directory as CALSK2 and
  758.           CALSK2 must not be renamed. CALSINST allows you to alter a number
  759.           of options such as:
  760.  
  761.                       Field             Defaults
  762.  
  763.           Appointment File Location     APP.DB
  764.           Default Days to Preview       7
  765.           Default Output Disk File      APP.RPT
  766.  
  767.           Highlight Foreground Color    Yellow
  768.           Standard Fore/Background      BrWhite/Blue
  769.           Standard Note Color           LtMagta
  770.           Standard Reminder Color       Yellow
  771.           Message Fore/Background       Black /Lt Gray
  772.  
  773.           Printer Setup String
  774.           Printer Termination String    ^L
  775.           Printer Page Length           0
  776.  
  777.           Video Max:                    Off
  778.           Weekly Separators:            Off
  779.           Print Notes:                  Off
  780.           Time Format:                  AM/PM
  781.  
  782.           ToDo/Task File(RTM) Location: SK2
  783.  
  784.                The fields are self explanatory but a brief explanation is
  785.           listed below. There is pop-up help <F1> available for each field.
  786.           Please note that if you press <ESC> the installation will be
  787.           canceled and any changes will be lost.
  788.  
  789.              A. Default Datafile Path & Filename
  790.  
  791.           CALSK2's uses the default SIDEKICK 2 Time Planner File - APP.DB.
  792.           If you have renamed your Time Planner file change CALSK2's
  793.           default here. The format is: d:\PATH\FILENAME.EXT.  If you omit
  794.           drive or path CALSK2 will search for the Time Planner file using
  795.           DOS 3.x defaults : Current Directory, CALSK2's Directory, and
  796.           Path.  You can always override this option with the /C Command
  797.           Line Option.
  798.  
  799.              B. Default Days for Report
  800.  
  801.           CALSK2 assumes you want to view the next seven days by default.
  802.           You can override this default each time you run CALSK2 with the
  803.           /D n command line option or you can change the default here.
  804.           Valid Range is 1-365.
  805.  
  806.  
  807.  
  808.           CALendar preview report for SideKick 2                       Page: 11
  809.  
  810.  
  811.              C. Default Output Disk File Name Help
  812.  
  813.           CALSK2 will send it's output report to a Disk File: APP.RPT if
  814.           you specify the /F option on the command line. If you wish to
  815.           change the file name enter it here. Format is:
  816.           d:\PATH\FILENAME.EXT. Omit the drive or path if you want the
  817.           report to go to the default drive and path. You can also specify
  818.           the file name with the /F command line option to override this
  819.           default.
  820.  
  821.              D. Default Screen Colors
  822.  
  823.           CALSK2 uses 6 Basic Colors; Highlighted Foreground, Standard
  824.           Foreground / Background, Task, Note Foreground, and Message
  825.           Foreground / Background.  Use the Space/+/- keys to toggle
  826.           through the color options.  The Color Sample Box shows what the
  827.           current color selections will look like (if saved).
  828.  
  829.              E. Print Initialization / Termination Strings
  830.  
  831.           CALSK2 will send Printer Initialization and Termination Strings
  832.           when the /P parameter is specified.  Enter the control codes
  833.           appropriate for your printer. To enter a Page Eject enter <CtrlP>
  834.           <CtrlL>. Only the <CtrlL> will display. You can enter multiple
  835.           codes.
  836.  
  837.              F. Default Print Page Length
  838.  
  839.           CALSK2 will issue a Page Eject (^L) and Print a new Heading at
  840.           the end of each page. CALSK2 defaults to 0 lines per page. Enter
  841.           the number of lines you would like printed on each page. If you
  842.           enter 0 no page eject will be issued.
  843.  
  844.              G. Default Video Mode
  845.  
  846.           CALSK2 has a command line switch (/V - Max Video) to control the
  847.           default video mode. You can turn on Max Video (43/50 Lines on
  848.           EGA/VGA Screens) with the /V switch or toggle the field here with
  849.           the Space/+/- keys.
  850.  
  851.              H. Weekly Separators Option
  852.  
  853.           CALSK2 can print Weekly Separators to indicate the end of each
  854.           week on the report. You can turn this option on with the /W
  855.           command line switch and/or you can toggle the default here with
  856.           the Space/+/- keys.
  857.  
  858.              I. Print Note Option
  859.  
  860.           CALSK2 will print up to 4096 bytes of note information associated
  861.           with each appointment. This option can be toggled on with the /N
  862.           [n] command line switch or you can toggle the field permanently
  863.           on in this install program. If turned on permanently here you can
  864.           always limit the note output by specifying /N 1 (or the limit of
  865.  
  866.           CALendar preview report for SideKick 2                       Page: 12
  867.  
  868.  
  869.           your choice on the command line. Toggle this field with the
  870.           Space/+/- keys.
  871.  
  872.              J. Default Time Format
  873.  
  874.           CALSK2 normally prints out times in AM/PM format. If you set
  875.           SideKick 2 to 24 Hr. format then you should also set this flag to
  876.           24 Hr. Toggle this field with the Space/+/- keys.
  877.  
  878.              K. Default ToDo/RTM Task File Location
  879.  
  880.           CALSK2 will integrate the Sidekick's ToDo list with the CALendar
  881.           reports if you specify "SK2" here and /T on the command line. Or
  882.           you can specify /T SK2 on the command line. Optionally, CALSK2
  883.           will read Task files from Resident TaskManager when you specify
  884.           the /T option on the command line.  If you wish to use the
  885.           Resident TaskManager file enter the name here.  Format is:
  886.           d:\PATH\FILENAME.EXT. Please make sure the Task File EXISTS!  You
  887.           can always specify a different file on the command line with /T
  888.           [Filename]. Resident TaskManager is available separately from
  889.           WetZoft Applications.
  890.  
  891.              L. Task Print Before/After Appointments
  892.  
  893.           By default (and if the /T option is specified) CALSK2 will print
  894.           your daily Tasks before your appointments. If you would like to
  895.           see your tasks printed after your appointments toggle the field
  896.           to AFTER.
  897.  
  898.              M. Reminder / Look Ahead Characters
  899.  
  900.           The Reminder and Look Ahead Characters have a special meaning to
  901.           CALSK2.  If the reminder character is found in PAST appointments
  902.           that appointment will be printed at the end of CALSK2's report as
  903.           a reminder. This appointment will continue to print until the
  904.           "!", or what ever character you chose, is deleted. The Look Ahead
  905.           character is for appointments in the future. It will also cause
  906.           selected appointments to print at the end of the report but the
  907.           printing will stop after the date has passed. If either of these
  908.           two characters conflict with other special characters you
  909.           regularly use in appointments you can change them here.
  910.  
  911.           *** Note: When using the reminder feature, CALSK2 will read
  912.           the entire Time Planner file from the beginning instead of
  913.           skipping right to the start date. Since this slows processing
  914.           on large Time Planner files this feature is turned off by
  915.           default. To activate it enter the character you want to use as
  916.           the "Reminder" character through the install program.
  917.  
  918.  
  919.  
  920.           CALendar preview report for SideKick 2                       Page: 13
  921.  
  922.  
  923.              N. Look Ahead Days
  924.  
  925.           If the /L switch is specified on the Command Line, CALSK2 will
  926.           search future appointments for ones that have been designated
  927.           with the Look Ahead Character. By default CALSK2 will search 45
  928.           Days in advance. If you want to change the time period enter a
  929.           new number between 1 and 365 here.
  930.  
  931.              O. Print End Times
  932.  
  933.           CALSK2, by default, prints the ending times of appointments on
  934.           it's report. This takes up about 9 extra characters. If you have
  935.           a lot of long appointments or would just prefer not to see the
  936.           end time printed - Set this field to "N".
  937.  
  938.              P. Always Include Task File
  939.  
  940.           CALSK2, by default, will always print out your ToDo List merged
  941.           with your CALendar data. If you wish to only print the ToDo's on
  942.           request, by specifying /T on the command line, change this option
  943.           to "N". As mentioned before, CALSK2 has an interface to Resident
  944.           Task Manager where it will read the file specified in Resident
  945.           Task File Location and merge your tasks with your appointments
  946.           for complete Time/Task management.  Normally you would have to
  947.           use the /T option on the command line to cause the Task file to
  948.           be read. If you would always like the Task file included set this
  949.           option to "Y".
  950.  
  951.              Q. Task Due Messages
  952.  
  953.           When CALSK2 displays ToDo List or Resident Task Manager items on
  954.           the report they will be accompanied with a message indicating it
  955.           is either Due or Past Due. If you would rather see a different
  956.           message or have a check box like "[] Task" then you can change
  957.           the message here.
  958.  
  959.           VII. ASSOCIATION OF SHAREWARE PROFESSIONALS
  960.  
  961.                The owner of WetZoft Applications is a member of the
  962.           Association of Shareware Professionals (ASP), an organization
  963.           formed in April 1987 to strengthen the future of shareware (user-
  964.           supported software) as an alternative to commercial software.
  965.           Its members, all of whom are programmers who subscribe to a code
  966.           of ethics, are committed to the concept of shareware as a method
  967.           of marketing.
  968.  
  969.                ASP wants to make sure the shareware principle works for
  970.           you.  If you are unable to resolve a shareware-related problem
  971.           with an ASP member by contacting the member directly, ASP may be
  972.           able to help.  The ASP Ombudsman can help you resolve a dispute
  973.           or problem with an ASP member, but does not provide technical
  974.           support for members' products. Please write to the ASP Ombudsman
  975.           at 545 Grover Road, Muskegon, MI 49442-9427 or send a Compuserve
  976.           message via CompuServe Mail to ASP Ombudsman 70007,3536
  977.  
  978.           CALendar preview report for SideKick 2                       Page: 14
  979.  
  980.  
  981.              A. The primary goals of the ASP:
  982.  
  983.                 To inform users about shareware programs and about
  984.                 shareware as a method of distributing and marketing
  985.                 software;
  986.  
  987.                 To encourage broader distribution of shareware through user
  988.                 groups and disk dealers who agree to identify and explain
  989.                 the nature of shareware;
  990.  
  991.                 To assist members in marketing their software;
  992.  
  993.                 To provide a forum through which ASP members may
  994.                 communicate, share ideas, and learn from each other; and
  995.  
  996.                 To foster a high degree of professionalism among shareware
  997.                 authors by setting programming, marketing, and support
  998.                 standards for ASP members to follow.
  999.  
  1000.           VIII. OTHER PROGRAMS BY WETZOFT APPLICATIONS
  1001.  
  1002.              A. Resident-TaskManager - RTM
  1003.  
  1004.                Resident-TaskManager is a memory-resident program to manages
  1005.           lists of tasks, reminders or ToDo's.  Really, this can be
  1006.           anything you want it to be: a general list of things to do, a
  1007.           list of appointments, tasks you've delegated, etc.
  1008.  
  1009.                Resident-TaskManager's most important feature is it's
  1010.           ability to load as a memory-resident program.  That means it's
  1011.           available to you whenever you need to use it.  And, it only uses
  1012.           about 6K while doing so.
  1013.  
  1014.           Resident-TaskManager has the following features for managing
  1015.           lists:
  1016.  
  1017.              . Multiple lists
  1018.              . Add, Modify, Delete, Repeat
  1019.              . Sorting
  1020.              . Prioritization
  1021.              . Easy date manipulation
  1022.              . A user-definable field
  1023.              . Audit Files
  1024.              . Simple Printing
  1025.  
  1026.                Resident-TaskManager provides the best combination of memory
  1027.           usage, simplicity, and features for managing small lists of
  1028.           tasks.
  1029.  
  1030.              B. CALRPT
  1031.  
  1032.                CALRPT is a program that produces a nicely formatted
  1033.           calendar report (Screen, Printer, or File) from Sidekick+'s
  1034.           Calendar file without invoking Sidekick+. This is especially
  1035.  
  1036.           CALendar preview report for SideKick 2                       Page: 15
  1037.  
  1038.  
  1039.           helpful in your AUTOEXEC file to show you what is on your
  1040.           Calendar for the next few days. To invoke CALRPT just type CALRPT
  1041.           from the DOS command line or place the command CALRPT somewhere
  1042.           in your AUTOEXEC.BAT file.
  1043.  
  1044.              C. CALTRV
  1045.  
  1046.                CALTRV, like CALSK2, is a program that produces a nicely
  1047.           formatted calendar report from Sidekick+'s Calendar file without
  1048.           invoking Sidekick+. The primary difference between CALTRV and
  1049.           CALRPT is that CALTRV is more paper oriented. That is it produces
  1050.           a more standard type of Daily, Weekly, and Monthly Calendar
  1051.           report. CALTRV was designed to be a replacement for Traveling
  1052.           Sidekick, by Borland International.
  1053.  
  1054.           RTM, CALRPT, and CALTRV are available separately on Compuserve in
  1055.           the BORAPP & IBMSYS Forums.
  1056.  
  1057.           IX. Version History
  1058.  
  1059.           1.00  April 1991    Initial Shareware Release
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.           CALendar preview report for SideKick 2                       Page: 16
  1095.  
  1096.